home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / GRAPHICS / GRAPHUTL / 2307B.ZIP / VFM14.ZIP / VFM.DOC next >
Encoding:
Text File  |  1990-04-24  |  32.8 KB  |  699 lines

  1. VENTURA FONT MACHINE version 1.4
  2.  
  3. __________________________________________________________________
  4.  
  5. If you like this program, please do one of the following:
  6.  
  7. Go down to your local bookstore and buy a copy of "Coven: A 
  8. Novel", by Steven William Rimmer, published by Ballantine Books. 
  9. In Canada, try Coles... they usually have it. Read the book and 
  10. tell your friends about it if you like it. Send us some comments 
  11. about the book or a photocopy of the cover and we'll consider you 
  12. a registered user of this program.
  13.  
  14. Alternately, send us $20.00, the normal user fee for this 
  15. software. (The book is $3.95 or $5.50 in Canada: considerably 
  16. cheaper than cash.) 
  17.  
  18. Registered users of this software are entitled to phone support, 
  19. notification of upgrades and good karma. Our address can be found 
  20. at the end of this file.
  21. __________________________________________________________________
  22.  
  23. Version 1.4 - Fixed a few obscure bugs, sped up a few things.
  24.  
  25. Version 1.3 - Added some searching capability to the routine 
  26.               that tries to find the HPLTOVFM.EXE and VFMTOWID.EXE
  27.               files. Previously, it would find them only so
  28.               long as they were on the DOS path... but not if they
  29.               were in the same directory as VFM.EXE
  30.  
  31. Version 1.2 - Fixed a real weird bug which caused some of the
  32.               basic fonts included with Ventura to be set up
  33.               improperly in width tables created by VFM. Improved
  34.               the sorting of file names and made the status
  35.               display window for width table creation a bit
  36.               more informative.
  37.  
  38. Version 1.1 - Fixed the bug in the batch file mode which caused 
  39.               VFM not to actually run anything from within a 
  40.               batch file. Whoops...
  41.  
  42. This program is a reasonably painless, menu driven front end to 
  43. create width tables for LaserJet soft fonts used with Ventura 
  44. Publisher. It's intended to drive Ventura when it's used with a 
  45. Hewlett Packard LaserJet Plus compatible printer... it won't be 
  46. any use with a PostScript device, and may have some troubles with 
  47. JLaser boards and other oddities.
  48.  
  49. When you buy Ventura, it comes with a host of sort of dull 
  50. fonts... notably Swiss and Dutch... and a width table to make 
  51. Ventura recognize their existence. This works well until you go 
  52. to add fonts to the system. Adding fonts, while totally practical 
  53. using the utilities supplied with Ventura, is very, very tedious. 
  54. You have to make up several batch and list files by hand, key in 
  55. a lot of stuff and hope to the goddess that it's all right. One 
  56. bad parameter and you get to start over.
  57.  
  58. It's not entirely user friendly.
  59.  
  60. VFM drives the two utilities which come with Ventura for adding 
  61. fonts, but it supplies them with the right files and parameters 
  62. automatically, so as to avoid all that typing. It allows you to 
  63. create width tables pretty effortlessly.
  64.  
  65. Before you can start using VFM, you must copy the HPLTOVFM.EXE 
  66. and VFMTOWID.EXE files from your Ventura utilties disk to your 
  67. hard drive, either into the same directory as VFM.EXE or 
  68. somewhere on your DOS path. HPLTOVFM.EXE lives in a subdirectory 
  69. called HPLJPLUS on the utilities disk for Ventura 2.0.
  70.  
  71.  
  72. Width tables and such
  73. _____________________
  74.  
  75. Ventura... at least when its driving a LaserJet... uses soft font 
  76. files, which are bit map definitions for each of the characters 
  77. which will get printed. The soft fonts are usually downloaded to 
  78. the printer each time a chapter is printed, which is why even 
  79. short documents take quite a while to print.
  80.  
  81. In order for Ventura to be able to know how wide each character 
  82. in a font is, it needs a table of numbers representing their 
  83. widths. Width tables are stored in files called <something>.WID, 
  84. with HPLJPLUS.WID being the usual one for use with a LaserJet. 
  85. This is copied to OUTPUT.WID when Ventura is installed. You can 
  86. only have one width table in memory at a time, but a width table 
  87. can hold the width values for as many fonts as you like, and you 
  88. will typically have a width table with every font available to 
  89. you as the default width table for Ventura.
  90.  
  91. Ventura allows you to add and remove fonts from an existing width 
  92. table. Both procedures are a bit laborious. Adding fonts to your 
  93. existing width table involves creating a new width table for the 
  94. fonts you want to add and then merging it into your standing 
  95. width table. Removing fonts involves killing them off one by one, 
  96. which takes some time if you want to annihilate a whole swath of 
  97. them.
  98.  
  99. In addition, when merging one width table with another, the 
  100. resulting table has the fonts ordered as they came from the two 
  101. tables, with the merged in group tacked onto the end of the first 
  102. lot. It's a lot easier to find them if they're alphabetic, but 
  103. Ventura offers you no easy way to reorder them.
  104.  
  105. Finally, if the new width table contains fonts which have the 
  106. same numbers as some of the fonts in the existing table, strange 
  107. things can happen. Unfortunately, there's no easy way to find out 
  108. how the fonts in an existing width table are numbered.
  109.  
  110. All this being as it is, it's a lot more convenient to create a 
  111. whole new width table, with all the fonts in your \VENTURA 
  112. directory included, such that they show up in the font selection 
  113. box in the order you want them and you have control over how 
  114. they're all numbered.
  115.  
  116. More on this in a sec.
  117.  
  118. Width tables have other functions under Ventura. As we just 
  119. noted, they tell Ventura which font number is associated with 
  120. each font Ventura can print with. This is a unique value for each 
  121. font in the table, and is used both when Ventura tells the 
  122. printer to change fonts and when it indicates that part of a 
  123. paragraph is printed in a different font. Some of these numbers 
  124. are more or less predefined by Ventura... such as the ones for 
  125. Swiss and Dutch... but you can assign numbers to your own fonts 
  126. as well.
  127.  
  128. The width table also tells Ventura the actual file name of a 
  129. font. For example, six point Dutch is contained in a file called 
  130. TMSRTINY.SFP under Ventura. These files can actually be called 
  131. anything you like, so long as the name in the width table agrees 
  132. with the one on your disk. Under Ventura 1.1, all the actual font 
  133. files must reside in the \VENTURA directory... under version 2.0, 
  134. this has been changed to allow them to reside in other places.
  135.  
  136. The width table tells Ventura about the weight of each font as 
  137. well... whether it's bold, italic, light and so on.
  138.  
  139. Finally, the width table tells Ventura about screen fonts. The 
  140. text you see on your screen is not directly derived from the soft 
  141. fonts that get downloaded to your printer. Instead, Ventura uses 
  142. screen font files. These are provided with Ventura to match 
  143. Courier, Swiss and Dutch, and there are various utilities about 
  144. which allow you to create matching screen fonts for any other 
  145. soft fonts you happen to have. Ventura has to know whether it 
  146. should display the text for any given tag in the default Swiss 
  147. screen font, the default Times screen font, the default Courier 
  148. screen font or a custom matching font created by you.
  149.  
  150. It's fairly clever about this, in that if it fails to find a 
  151. matching screen font it has lots of options, eventually falling 
  152. back to one of the defaults.
  153.  
  154. Custom screen fonts are usually called <something>.EGA. If one 
  155. had a font called CB360RPN.SFP, the corresponding screen font 
  156. would be CB360RPN.EGA.
  157.  
  158. The only drawbacks to having custom screen fonts are that they 
  159. take up disk space, memory in Ventura's internal buffers and time 
  160. when they load. Text which is set in a font which has no 
  161. corresponding screen font will come up on your screen properly 
  162. justified for the font you've selected even if it's shown in, 
  163. say, the Dutch screen font, so whether or not you use matching 
  164. screen fonts is up to you. Certainly you should use a bit of 
  165. discretion with them. For example, the screen font for Palatino 
  166. would be almost identical to the default Dutch screen font... 
  167. it's not worth bothering to have one.
  168.  
  169. Note that this version of VFM does not directly generate screen 
  170. fonts... we're working on that... but it does allow you to 
  171. indicate whether there are matching screen fonts available for a 
  172. particular soft font when you have VFM create a width table for 
  173. you.
  174.  
  175.  
  176. Fonts
  177. _____
  178.  
  179. As an inital note... you probably already know this... the 
  180. primary text soft fonts which come with Ventura are called Swiss 
  181. and Dutch. These correspond with Times Roman and Helvetica in the 
  182. real world. These names are copyrighted, however, so Ventura 
  183. elected to use their own made up names rather than get into 
  184. royalties or litigation. 
  185.  
  186. It's also worth noting that Ventura interchangeably uses "width 
  187. table" and "font metric file" to mean the same thing. We'll call 
  188. it a width table here as it takes less typing and doesn't sound 
  189. as Martian.
  190.  
  191. If you have a large collection of soft fonts, you'll probably 
  192. have gotten into loading the ones you need onto your hard drive, 
  193. using them and then blowing them away afterwards to free up all 
  194. the space they occupy. This works well, except that you have to 
  195. keep regenerating those nasty little width tables by hand.
  196.  
  197. When VFM boots up, it finds all the soft font files in your 
  198. \VENTURA directory... or wherever else you tell it to look... and 
  199. figures out what they are. Specifically, it will assign each one 
  200. a name, like "Times" or "Palatino" to each one, a weight, like 
  201. medium or bold, a font number, a size and so on. It will then 
  202. display the lot in a menu. You can scroll through the menu and 
  203. select the ones you want to make a width table for. If you've 
  204. just copied all some new fonts into your \VENTURA directory, and 
  205. wish to create an updated width table, you can just select all of 
  206. them.
  207.  
  208. When all the fonts you want to have in your width table are 
  209. selected, you can tell VFM to get its buns moving and create you 
  210. a table by hitting W. It uses two of the utilities provided on 
  211. disk eleven of your Ventura installation set, HPLTOVEM.EXE and 
  212. VFMTOWID.EXE. It will execute the first one repeatedly for each 
  213. file you have selected, generating .VFM files for each. It will 
  214. create a list of these VFM files and pass it to VFMTOWID.EXE when 
  215. it's done. The result will be a width table for all the selected 
  216. fonts, called whatever you want it to be called. You can get into 
  217. Ventura and load in the new width table whenever you need it.
  218.  
  219. We'll get to that shortly.
  220.  
  221. By the way, VFM expects to find HPLTOVFM.EXE and VFMTOWID.EXE 
  222. somewhere on your DOS path. It won't boot unless it does... 
  223. unless it has been told to run in batch file mode. Check this out 
  224. below.
  225.  
  226. What makes VFM so convenient to use is its ability to look at a 
  227. font name and decide what font it is. This information is usually 
  228. not contained in the font file. Instead, it's held in a file 
  229. nominally called VFM.TBL. This is a set of clues to help VFM 
  230. figure out what those cryptic eight character file names really 
  231. mean.
  232.  
  233. A sample VFM.TBL file is included with this package. You'll 
  234. probably want to add to it to include your own particular soft 
  235. fonts. We suggest you leave those entries that are in it as they 
  236. are unless you have specific reason to change them.
  237.  
  238. Soft font files are usually called <something>.SFP. The 
  239. corresponding landscape fonts are called <something>.SFL. The 
  240. <something> can be any eight characters, of course, but VFM 
  241. regards them as falling into one of three decoding classes.
  242.  
  243. The first of these, class one, handles the fonts which come with 
  244. Ventura itself. The second... predictably class two... handles 
  245. the popular Font Factory / Qume Alcatel soft fonts, which 
  246. includes faces from Compugraphic and ITC. The third takes care of 
  247. everything else. It assumes that everything else follows the 
  248. naming convention which is found in the SoftCraft font installer, 
  249. to wit:
  250.  
  251.     BA120RPN.SFP
  252.  
  253. The first two letters are an arbitrary name designation. There 
  254. are a number of these which are sort of reserved by SoftCraft... 
  255. which only matters if you have a SoftCraft font installer, of 
  256. course. The next two characters are the point size. The 'R' means 
  257. "roman" or, if you prefer, "regular". It could also be I or 
  258. italic, B for bold, L for light or T for bold italic.
  259.  
  260. If you look at the VFM.TBL file included with this package, 
  261. you'll find entries for all the Ventura fonts, all the Font 
  262. Factory / Qume Alcatel fonts as of this writing, the SoftCraft 
  263. fonts and a few other fonts. The other fonts, by the way, came 
  264. from the Digi-fonts library... a stunningly inexpensive source of 
  265. soft fonts. The whole library, something over two hundred and 
  266. fifty scaleable fonts, is less than four hundred bucks. Contact 
  267. Digi-fonts, 3000 Youngfield Street, Suite 285, Lakewood CO 80215 
  268. (303) 233-8113.
  269.  
  270. We'll get into how to modify this table shortly.
  271.  
  272. To get things going, let's assume that your fonts are indeed 
  273. located in a directory called C:\VENTURA. Just type VFM. It will 
  274. show you a title screen. Hit a key to get going. It will wait a 
  275. few moments while it loads and sorts your soft font names. It 
  276. will then show you a screen with all their names, what it decoded 
  277. them as and some other data.
  278.  
  279. It's worth noting that, while it meddles with the names a lot, 
  280. VFM never actually affects your soft font files themselves. It 
  281. just makes width tables based on them.
  282.  
  283. The arrow keys on your keyboard will move the cursor bar up and 
  284. down... if you try to move past the bottom of the screen it will 
  285. scroll up by one line. The PgUp and PgDn keys will move by one 
  286. screenful. The HOME and END keys move to the extremes of the 
  287. list. If you only have the soft fonts that came with Ventura in 
  288. your \VENTURA directory, the list will be pretty short. Note that 
  289. the window usually fills the whole screen, but if the list is 
  290. less than a screenful it will shrink to accommodate it.
  291.  
  292. You can "tag" any entry in the list... that is, select it for 
  293. inclusion in the width table you'll eventually create... by 
  294. hitting T when the cursor is over the file you want to tag. If 
  295. you hit Enter instead, the currently selected file will be tagged 
  296. and the cursor will move down one line. If you hit U while the 
  297. cursor is over a tagged file, it will be untagged. Tagged files 
  298. are displayed in highlighted text, while untagged ones are shown 
  299. in normal text. 
  300.  
  301. You can also hit C to untag all the files and V to tag them all. 
  302. If you have just added a few soft fonts to your directory and 
  303. want a new width table for all your fonts, use V to tag all the 
  304. entries. It's also useful to use V to tag all the entries in the 
  305. list and then untag a few if you want a width table which 
  306. contains most of the fonts in your \VENTURA directory.
  307.  
  308. It's worth noting that if you want to add a few new fonts to an 
  309. existing width table, you have two choices. You can create a new 
  310. width table for just your new fonts, get into Ventura and merge 
  311. it into your existing width table using the "Add/Remove Fonts" 
  312. line of the Options menu, or you can create a completely new 
  313. width table for all the fonts you have and select it with the 
  314. "Set Printer Info" line of the Options menu of Ventura. The 
  315. latter approach is faster and neater, as you can have all the 
  316. fonts appear in Ventura's font selector box in alphabetical 
  317. order... and you should avoid any potential font number 
  318. clashes... but you can do it either way.
  319.  
  320. Normally the fonts in the VFM entry list are shown in 
  321. alphabetical order based on the names of the fonts. If you hit B 
  322. they'll be re-ordered based on the names of their files. Hit A to 
  323. return them to alphabetical order by their name. If you change 
  324. one of their names... as we'll get to... you might want to use A 
  325. to resort the list. The order of the list determines the order in 
  326. which the font names will appear in the Ventura font selector. 
  327. It's highly preferable to have the names in the A sort mode 
  328. before you use W to make a width table... odd things may happen 
  329. if you do not.
  330.  
  331. Normally you will not want to change the data in an entry. If 
  332. you've set up VFM.TBL correctly, all the data will be correct. 
  333. However, you can change it for individual entries if you want to. 
  334.  
  335. Hit D to edit the font name for the currently selected font. You 
  336. might want to change "Dutch" to "Times", for example, although 
  337. this should properly be done in the VFM.TBL file. The editable 
  338. fields in VFM behave like the BASIC line editor or like 
  339. DOSEDIT... you can cursor around in the field, toggle the insert 
  340. mode on and off with the Ins key and so on. Hit Enter when you're 
  341. done.
  342.  
  343. Hit P to change the point size of the current font. Hit S to 
  344. change the screen font designation of the current font. This 
  345. field must contain H,T,C or M... for Helvetica, Times, Courier or 
  346. Matching. Hit N to change the font number. Be careful with this.. 
  347. you can really confuse Ventura by having multiple font numbers 
  348. for different sizes of what it thinks is the same font.
  349.  
  350. Hit F to change the face of the current font, that is, whether 
  351. it's medium, italic and so on.
  352.  
  353. Avoid editing the font data from within VFM unless you really 
  354. have to. About the only time it should become necessary to edit 
  355. this data in this way would be to accommodate a weirdly named soft 
  356. font file you don't want to rename for some reason.
  357.  
  358. Note that the changes you make to these fields in VFM are not 
  359. saved back to VFM.TBL. You have to edit the table file separately 
  360. to make the changes permanent.
  361.  
  362. When you have all the font data in the list tagged and set up as 
  363. you want it, hit W to make the width table. It will ask you is 
  364. you really want to create the table... the process can be a bit 
  365. lengthy if you've selected it by accident. Hit Y. It will then 
  366. ask you for an eight character file name for the width table. 
  367. Ventura's sample chapters default to a table file called 
  368. OUTPUT.WID... if you call your width file this you won't have to 
  369. manually load in a new width file with the "Set Printer Info" 
  370. option. Of course, you'll wipe out your default width table, 
  371. requiring that you find it on your Ventura disks and manually 
  372. recopy it back to your hard drive if something goes wrong.
  373.  
  374. I usually call my width table CUSTOM.WID.
  375.  
  376. Make sure you only type the file name itself in this field, not 
  377. the extension. If you want the width table to be called 
  378. CUSTOM.WID, type CUSTOM. The case doesn't matter.
  379.  
  380. When you hit Enter after you type in your width table name, VFM 
  381. will go to work. It will tell you what it's up to as it goes. A 
  382. huge font collection may take a couple of minutes to complete. Be 
  383. patient... the process isn't interruptable. When it's done, hit 
  384. any key to get back to the main screen.
  385.  
  386. Hit Q to quit back to DOS. This will show you the beg notice. 
  387. Please read it and send us some money.
  388.  
  389. Note that all the messages from HPLTOVFM and VFMTOWID are 
  390. suppressed when VFM creates a width table in this way. Normally 
  391. there should be no errors in this process... about the only 
  392. possible one is a full disk. VFM has no way of knowing whether 
  393. HPLTOVFM or VFMTOWID have done something untoward... if things 
  394. don't turn out as you think they should, you can repeat the 
  395. process for creating your width table with the -B1 parameter set 
  396. for VFM to run HPLTOVFM and VFMTOWID from a batch file so you can 
  397. see what they print to the screen. Check this feature out below.
  398.  
  399.  
  400. More stuff
  401. __________
  402.  
  403. There are a number of things you can change in VFM if you want 
  404. to. Most of the time this isn't necessary or even a particularly 
  405. good idea.
  406.  
  407. This is a list of the command line options. It can also be seen 
  408. by typing VFM HELP at the command line.
  409.  
  410.    -F<string>    This is the path to your SFP files, to wit, your
  411.                  \VENTURA directory. Defaults to C:\VENTURA
  412.    -K<integer>   When not zero, VFM will keep all its scratch files.
  413.                  This defaults to OFF
  414.    -B<integer>   When not zero, VFM will create a batch file to make width
  415.                  tables, rather than running HPLTOVFM and VFMTOWID directly.
  416.                  This defaults to off. (See the DOC file for more about this).
  417.    -T<string>    This is the path to the VFM.TBL file. Defaults to VFM.TBL
  418.    -S<string>    This is the file specification for the soft font files.
  419.                  Defaults to *.SFP.
  420.    -N<integer>   Video attribute for normal text. Defaults to 7
  421.    -H<integer>   Video attribute for bright text. Defaults to 15
  422.    -I<integer>   Video attribute for inverse text. Defaults to 112
  423.    -A<integer>   Video attribute for flashing text. Defaults to 240
  424.  
  425. Unlike as with most utilities, all of these settings are memorized 
  426. by VFM in a file called VFM.CFG. As such, for example, if you set 
  427. the screen colours once, they'll stay set for all subsequent 
  428. invocations of VFM until you specifically change them or until 
  429. you delete VFM.CFG. This latter move is a simple way to return 
  430. VFM to its default settings.
  431.  
  432. Note that VFM expects to find VFM.CFG in the current directory. 
  433. If you put VFM.EXE on your DOS path and boot it from some other 
  434. directory, it will assume that VFM.CFG does not exist, return to 
  435. its defaults and create a new VFM.CFG file when it exits.
  436.  
  437. Multiple command line parameters can be combined in a single 
  438. invocation of VFM.
  439.  
  440. The -F parameter tells VFM to look for your soft fonts in some 
  441. directory other than C:\VENTURA. This might be useful if you have 
  442. lots of fonts under Ventura 2.0... it shouldn't be needed under 
  443. Ventura 1.1.
  444.  
  445. The -K parameter determines how VFM manages its scratch files. 
  446. Normally it creates a number of scratch files when it's making a 
  447. width table and then deletes them afterwards. It you include -K1 
  448. on the command line, however, it will leave all its scratch files 
  449. on your hard drive. If you check out your \VENTURA directory 
  450. after VFM is done you'll see an assortment of .VFM files and a 
  451. <something>.LST file named after your new width table. Use -K0 to 
  452. turn this parameter off if you've previously set it on.
  453.  
  454. The -B parameter will cause VFM to create a batch file rather 
  455. than running HPLTOVFM and VFMTOWID directly. If you ask for a 
  456. width table called CUSTOM.WID with this parameter on, it will 
  457. create a file called CUSTOM.BAT in your \VENTURA directory. When 
  458. you get out of VFM, execute this batch file in your \VENTURA 
  459. directory to create the width table you asked for. This feature 
  460. is useful if you are having trouble with VFM and want to see any 
  461. error messages generated by HPLTOVFM and VFMTOWID, as these are 
  462. usually suppressed by VFM when it runs these programs directly. 
  463. The parameter -B1 turns the batch file mode on, and -B0 turns it 
  464. off. It's usually off.
  465.  
  466. The -T parameter sets the name of the VFM.TBL file... usually 
  467. it's VFM.TBL, of course.
  468.  
  469. The -S parameter defines the specification for your font files. 
  470. This is usually "*.SFP". You might change it to "*.SFL" to make a 
  471. width table for landscape fonts, or to something more specific, 
  472. like "CG*.SFP" to include only certain fonts in the VFM list.
  473.  
  474. The final four parameters set the screen colours. These default to 
  475. black and white, but you can make them more colourful if you want 
  476. to. The values passed to them are standard PC screen colour 
  477. numbers... check out any decent PC book to explain how they're 
  478. derived.
  479.  
  480. One minor inconvenience, in using VFM, is that the original 
  481. OUTPUT.WID file which comes with Ventura for use with the LaserJet
  482. plus has a windth table in it for Courier, which is a built in
  483. font resident in the printer. A width table created by VFM will
  484. not include this, for obvious reasons. The best way to regain the
  485. use of Courier, assuming you actually want the beast, is to copy
  486. HPLJPLUS.WID to COURIER.WID, and then to use the Add/Remove Fonts
  487. function of the Options menu to delete everything but Courier
  488. from this width table. When you create a new width table with VFM, 
  489. you'll have to get into Ventura and merge COURIER.WID with your
  490. new table. Fortunately, with only one font in it this doesn't take
  491. very long.
  492.  
  493.  
  494. Adding to VFM.TBL
  495. _________________
  496.  
  497. VFM.TBL can be edited with any text editor, such as WordStar in 
  498. its non-document mode. It can be up to three hundred and eighty-
  499. four lines long... lines beyond this are ignored. Blank lines are 
  500. best avoided, and you should make sure that the last line is 
  501. actually terminated by a carriage return or it may not be read 
  502. properly.
  503.  
  504. Each line in this file represents one font type. This can mean 
  505. different things. The thing which determines how many fonts fall 
  506. into a type is actually how their soft font files are named. For 
  507. example, all the soft font files for the Dutch... or Times... 
  508. font which come with Ventura start with the letters TM. As such, 
  509. all the Times font files fall into one type.
  510.  
  511. The letters TM here are called the type "key".
  512.  
  513. Inconveniently, the Font Factory / Qume Alcatel fonts have four 
  514. groups for most font families, one each for medium, italic, bold 
  515. and bold italic. As such, these fonts are usually held in four 
  516. lines of this file, or four types. The Font Factory / Qume 
  517. Alcatel fonts are designated by six character keys, of which the 
  518. first two characters are CG, for "Compugraphic" and the last four 
  519. are the code number of the particular face. We didn't make this 
  520. up... the fonts come named this way and it'd be a pig to change 
  521. them all.
  522.  
  523. Each line of the VFM.TBL file consists of a key and some 
  524. parameters which tell VFM about the font which the key represents. 
  525. Some of these are optional. If you leave off any of the non-
  526. optional ones, VFM will default to values you probably won't 
  527. like.
  528.  
  529. The following are some example lines from VFM.TBL.
  530.  
  531. HELVTINY /F=Helvetica /N=2 /H /Q=1 /W=M /S=6
  532. TM /F=Times /N=14 /T /Q=1
  533. SYMB /F=Symbol /N=128 /T /Q=1
  534. CG2500 /F=CG-Times /N=15 /T /Q=2 /W=M
  535. CG1674 /F=Avante-Garde /N=51 /H /Q=2 /W=T
  536. GL /F=Gaul /N=137 /T /Q=3
  537. SX /F=Saxon /N=138 /T /Q=3
  538. GM /F=GoudyMediaevl /N=140 /T /Q=3
  539. DU /F=Dublin /N=136 /T /Q=3
  540. CB /F=CooperBlack /N=8 /M /Q=3
  541. CL /F=Cloister /N=10 /T /Q=3
  542.  
  543. The first field in each line is the key, which can be anywhere 
  544. from one to eight characters long. In decoding each file name, 
  545. VFM will compare the file name to the key for as many characters 
  546. as are in the key to see if it matches, applying the following 
  547. parameters to that file if it does. Note that the keys are 
  548. scanned in the order that they appear in the VFM.TBL file. This 
  549. can cause problems if you aren't careful. If you have a line like
  550.  
  551. CG /F=Calligrapher /N=138 /T /Q=3
  552.  
  553. before one like
  554.  
  555. CG2500 /F=CG-Times /N=15 /T /Q=2 /W=M
  556.  
  557. The second line will never be reached because all the soft font 
  558. files which start with CG will be assigned to the first key. To 
  559. avoid this, put the lines with the longest keys at the top of 
  560. your VFM.TBL file as a rule.
  561.  
  562. The next thing which VFM wants to know about a font type, as 
  563. found in one of these lines, is it's decoding class. This is 
  564. specified by the /Q parameter. This must be /Q=1 if the font is 
  565. one of those which came with Ventura, /Q=2 if the font is named 
  566. in the convention of the Font Factory / Qume Alcatel fonts or 
  567. /Q=3 if the font is named in the convention of the SoftCraft font 
  568. installer, as described earlier in this file. 
  569.  
  570. The /F parameter associates an actual name with the font file. 
  571. This can be up to thirteen characters long, and can be whatever 
  572. you want to appear in the Ventura font selector box for that 
  573. font. It can contain no spaces.
  574.  
  575. The /N parameter assigns a unique font number to the font in 
  576. question. These can be assigned arbitrarily if you want to, or 
  577. you can see what's in the Ventura manual. Check out page K-15 for 
  578. version 1.1. It's a good idea to leave the decode class one and 
  579. two numbers as they are in the default version of VFM.TBL. You 
  580. can add your own numbers to class three fonts as you like, so 
  581. long as they don't clash with those already in use in the VFM.TBL 
  582. file or in any other width table you might merge tables created 
  583. with VFM into. The numbers can't be any higher than 255.
  584.  
  585. The /W parameter sets the font weight. It can be /W=M for medium, 
  586. /W=I for italic, /W=L for light, /W=B for bold or /W=T for bold 
  587. italic. This parameter should be left off class three fonts, as 
  588. VFM will figure it out for itself from the file name. 
  589.  
  590. The /S parameter sets the font size. Usually this is not included 
  591. in an entry in VFM.TBL, as VFM is supposed to be able to work it 
  592. out for itself from the file name. However, it is used in the 
  593. smallest sizes of class one fonts, which are perversely called 
  594. <something>TINY.SFP, rather than being given actual size 
  595. designations in their font names. Tiny means six point to 
  596. Ventura.
  597.  
  598. The /H, /T, /C and /M parameters set the screen font to be used 
  599. with the font in question to Helvetica, Times, Courier or 
  600. Matching respectively.
  601.  
  602. The parameters can be set in any order.
  603.  
  604. If, upon booting up VFM you find that some fields in the main 
  605. screen are set to "Unknown", rather than what they should be, VFM 
  606. is probably misinterpreting your entries in VFM.TBL. 
  607.  
  608.  
  609. Stray bits
  610. __________
  611.  
  612. If you have some screen fonts which you don't know the numbers 
  613. of, you can find out using DEBUG. The first byte of the .EGA 
  614. screen font file is the font number which the screen file 
  615. corresponds to... in hex.
  616.  
  617.  
  618. Moral dogma
  619. ___________
  620.  
  621.  
  622. If you like this program and find it useful, you are requested to 
  623. support it either by buying the book mentioned at the top of this 
  624. file or by sending us $25.00. We'd rather you bought the book. 
  625. This will entitle you to telephone support, notification of 
  626. updates and other good things like that. More to the point, 
  627. though, it'll make you feel good. We've not infested the program 
  628. with excessive beg notices, crippled it or had it verbally insult 
  629. you after ten days. We trust you to support VFM if you like 
  630. it.
  631.  
  632. Oh yes, and if you fail to support this program and continue to 
  633. use it, a leather winged demon of the night will tear itself, 
  634. shrieking blood and fury, from the endless caverns of the nether 
  635. world, hurl itself into the darkness with a thirst for blood on 
  636. its slavering fangs and search the very threads of time for the 
  637. throbbing of your heartbeat. Just thought you'd want to know 
  638. that.
  639.  
  640. We are
  641.                       Alchemy Mindworks Inc.
  642.                           P.O. Box 500
  643.                          Beeton, Ontario
  644.                              L0G 1A0
  645.                              Canada
  646.  
  647. Other programs we've done that you might like include:
  648.  
  649. Scoop    -  MacPaint, GEM/IMG and PC Paintbrush file readers, 
  650.             with Epson FX-80, LaserJet and PostScript printer 
  651.             support. Drives CGA, EGA, VGA and Hercules cards.
  652. HP_Slash -  Make LaserJet soft fonts smaller by selectively excising
  653.             those characters you'll never use.
  654. Calendar -  Slick perpetual calendar that tells you when the 
  655.             equinoxes happen, what day Michaelmas fell on in 1705 
  656.             and so on.
  657. gemCAP   -  Capture graphics screen in GEM/IMG paint format, 
  658.             suitable for inhalation into Ventura.
  659. CPM2DOS  -  Read CP/M formatted disks on your PC.
  660. ADDRESS  -  Memory resident envelope addresser with graphics.
  661. MCOPY    -  Copying program which packs as many files as possible
  662.             onto a floppy, pauses when the current floppy is
  663.             full and asks for another one.
  664. GRAFCAT  -  Prints sixteen graphics files per page to create a 
  665.             visual record of your image file collection. The 
  666.             graphics can be any mixture of MacPaint, GEM/IMG, PC 
  667.             Paintbrush PCX and PCC and GIF files. GIF files are 
  668.             dithered to black and white. Works with any laser 
  669.             printer that supports LaserJet Plus or PostScript 
  670.             emulation.
  671. GRAPHIC
  672.  WORKSHOP - This is the last work in image programs. It converts, 
  673.             prints, views, dithers and halftones MacPaint, 
  674.             GEM/Ventura IMG, PCX, GIF, TIFF and EPS files. It 
  675.             drives CGA, Hercules, EGA, VGA, Paradise and ATI VGA 
  676.             Wonder cards. It features batch processing, extended 
  677.             and expanded memory support, an intuitive user 
  678.             interface and easy to follow menus. It allows you to 
  679.             convert colour image files into superb black and 
  680.             white clip art for desktop publishing, among other 
  681.             things. 
  682.  
  683. If you can't find them in the public domain, they're available 
  684. from us for $20.00 each. Graphic Workshop is $35.00. Source is 
  685. available for Scoop, for $25.00.
  686.  
  687. Legal dogma
  688. -----------
  689. The author assumes no responsibility for any damage or loss 
  690. caused by the use of these programs, however it comes down. 
  691.  
  692. All the trademarks used herein are registered to whoever it is 
  693. that owns them. This notification is given in lieu of any 
  694. specific list of trademarks and their owners, which would not be 
  695. as inclusive and would probably take a lot longer to type. 
  696.  
  697. That's it...
  698.  
  699.